home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 2 / Apprentice-Release2.iso / Tools / Languages / Icon 8.1 / met / Documentation / User Guide < prev    next >
Encoding:
Text File  |  1992-02-09  |  3.7 KB  |  102 lines  |  [TEXT/PICN]
  1. User Guide for Version 8.0 of Icon for the Macintosh
  2.  
  3. Introduction
  4.  
  5. The translator (Icont) and interpreter (Iconx) for Version 8.0 of the Icon 
  6. programming language have been ported to the Macintosh using THINK C 5.0.1.
  7. The ported applications do NOT support:
  8.  
  9.     external C functions
  10.     UNIX-like system() call
  11.     UNIX-like pipes
  12.     launching Iconx from Icont.
  13.  
  14. The ported software has been tested on the Macintosh SE (System 7), 
  15. Macintosh IIci (System 6), and the Macintosh IIfx (System 6).
  16.  
  17. Source Files
  18.  
  19. A text editor is not included with this release.  If the editor of 
  20. choice used to create Icon source files can be configured, the file type 
  21. should be set to 'TEXT', and the creator to 'I8TR'.  Setting creator is 
  22. not required for successful operation of the translator, but does permit 
  23. the Finder to correctly identify the files in either the icon or name 
  24. view.  In addition, double-clicking on the source file icon will cause 
  25. the Finder to launch Icont.
  26.  
  27. Binary Files
  28.  
  29. The icode binary files produced as output from the translator (icont) 
  30. have a file type of 'ICOD' and a creator of 'I8IN'.  Double-clicking on 
  31. the binary document icon will cause the Finder to launch Iconx.
  32.  
  33. User Interface
  34.  
  35. The THINK C console feature is used for both icont and iconx, providing 
  36. a UNIX-like user interface.  There are three components to the 
  37. interface:  the command line; a radio button area for an alternate 
  38. standard input source; a radio button area for an alternate standard 
  39. output target.  The console interface will copy the application name 
  40. (icont or iconx) into the command line and the user has only to enter 
  41. either the Icon source file name, or the binary (icode) file name.  The 
  42. normal source for standard input is the Macintosh keyboard, and standard 
  43. output will appear in the window provided by the console interface.  
  44. Standard error output cannot be redirected, and will also appear in the 
  45. console output window.  Keyboard input end-of-file indication is a 
  46. Control-D key combination.
  47.  
  48. When either icont or iconx have terminated execution, the console window 
  49. title bar will display the message "press <<return>> to exit" and then 
  50. pause.  After pressing the Return key, the application will complete the 
  51. termination process and exit to the Finder.
  52.  
  53. There is an escape hatch available for programs that misbehave.  It is 
  54. possible to abort a program by pressing the Command-. key combination.  
  55. Note that this action is only effective if the program is performing an 
  56. I/O operation.  A message is printed on standard output indicating the 
  57. program was terminated by the user.
  58.  
  59. Below are shown several user interface examples:
  60.  
  61. Compile an Icon program and allow any diagnostics to appear on the 
  62. screen:
  63.  
  64.     Command line:  icont  program.icn
  65.     Standard input buttons:  console selected
  66.     Standard output buttons:  console selected
  67.  
  68. Compile an Icon program and do not perform the link step:
  69.  
  70.     Command line:  icont  -c  program.icn
  71.     Standard input buttons:  console selected
  72.     Standard output buttons:  console selected
  73.  
  74. Execute Icon program, with standard input from keyboard and output to 
  75. the screen:
  76.  
  77.     Command line:  iconx  program
  78.     Standard input buttons:  console selected
  79.     Standard output buttons:  console selected
  80.  
  81. Execute Icon program, with standard input from a disk file, and the 
  82. standard output to a disk file:
  83.  
  84.     Command line:  iconx  program
  85.     Standard input buttons:  file selected
  86.     Standard output buttons:  file selected
  87.  
  88. The following Icon translator (icont) options are supported on the 
  89. command line:
  90.  
  91.     -c        compile only, no link step
  92.     -e file        select an alternate stderr file
  93.     -o file        select output file name
  94.     -s        suppress informative messages
  95.     -u        warn about undeclared ids
  96.     -t        turn on procedure tracing
  97.  
  98. Enjoy!
  99.  
  100. Don Klett
  101.  
  102. February 9, 1992